Names Soup Format from pg 16-15 of the NPReference manual in Docviewer format.
For best viewing, set your tabs stops to 20 chars.

This section describes the format of entries in the Names soup. Five different types of entries are stored in this soup: persons, owners, groups, companies, and worksites. You can identify an entry by calling the ClassOf function on the entry. ClassOf(entry) returns one of the following symbols: 'person, 'owner, 'group, 'company, or 'worksite. 
The slots contained in these entry frames are described in Person Entries (page 16-15), Owner Entries (page 16-18), Group Entries (page 16-20), Company Entries (page 16-21), and Worksite Entries (page 16-22).

Person Entries

Person entries consist of a frame with the following slots:
Slot descriptions
version	The version number of the Names application.
class	The symbol 'person.
cardType	An integer; see Table 16-1 Names card layouts.
name 	A frame with the following slots:
	honorific	A string or rich string for an honorific title; e.g., Ms. or Dr.
	first	A string or rich string for a first name.
	last	A string or rich string for a last name.
	title	A string or rich string for a job title.
names	An array of affiliated names, such as company contacts, family members, and so on, added by the user by picking Affiliate from the Add picker. This array contains frames such as that for the name slot.
company	A string or rich string for the company name.
title	A string or rich string representing this persons title at the company stored in company.
companies	An array of frames of type {company: stringOrRichString, title: stringOrRichString}. 
address	A string or rich string for the first line of an address.
address2	A string or rich string for the second line of an address.
addresses	An array of frames for additional addresses. These frames contain the following slots: address, address2, city, region, postal_code, and country. 
	city	A string or rich string for a city.
	region	A string or rich string for region (a state in the U.S.).
	postal_code	A string or rich string for postal code (zip code in U.S.).
	country	A or rich string naming the country. If this is a standard (not rich) string that is recognized by the system as the name of a country, it will have a class as set by SetCountryClass; for more information on this, see the description of SetCountryClass.
phones	An array that contains strings or rich strings for phone numbers. The user can set the class of this string by picking from the Phones popup. The built-in phone classes are:
	phone
	homePhone
	workPhone
	faxPhone
	carPhone
	mobilePhone
	homefaxPhone
email	A string or rich string for an e-mail address. The user can set the class of this string by picking from the Email popup. The built-in e-mail classes are:
	|string.email|
	|string.email.internet|
	|string.email.aol|
	|string.email.compuserve|
	|string.email.mcimail|
	|string.email.attmail|
	|string.email.easylink|
	|string.email.prodigy|
	|string.email.genie|
	|string.email.delphi|
	|string.email.msn|
	|string.email.interchange|
	|string.email.radiomail|
emailAddrs	An array of frames of additional e-mail addresses with the following slot:
email	 A string or rich string. The user can set the class of this string by picking from the Email popup. The built-in e-mail classes are listed under the email slot.
emailPassword	Always nil.
pagers	An array of pager information frames. Each frame can have the following slots:
pagerNum	A string or rich string for a pager number. The user can set the class of this string by picking from the Pagers popup. The built-in pagers classes are:
	|string.pager|
	|string.pager.skytel|
	|string.pager.mobilcomm|
	|string.pager.embarc|
pagerPIN	A string or rich string for a pager PIN.
bday	Either an integer for the date the user entered for the birthday in the number of minutes passed since midnight, January 1, 1904, or a string or rich string. 
bdayEvent	An alias to a Dates event. For more information on entry aliases, see Chapter 11, Data Storage and Retrieval, in Newton Programmers Guide.
anniversary	Either an integer for the date the user entered for the anniversary, in the number of minutes passed since midnight, January 1, 1904, or a string or rich string.
anniversaryEvent
An alias to a Dates event. For more information on entry aliases, see Chapter 11, Data Storage and Retrieval, in Newton Programmers Guide.
notes	An array of note objects. Each element in this array is a frame with the same format as the data slot in a soup entry in the Notes application; see Notes Soup Format (page 16-82).
sorton	A string (not a rich string because of sorting).

Owner Entries

Owner entries consist of a frame with the same slots as in Person Entries (page 16-15). However, three of the slots hold different values, and there is an additional slot. The following three slots exist in person entries, but have different meanings:
Slot descriptions
class	The symbol 'owner.
emailPassword	A string for the owners e-mail password.
emailAddrs	An array of frames of additional e-mail addresses with the following slots:
email	 A string or rich string. The user can set the class of this string by picking from the Email popup. The built-in e-mail classes are listed under the email slot for person entries.
emailpassword
A string.
There is one additional slot in owner entries:
owner	A frame with the slots shown below.
Slot descriptions for owner frame
bankAccounts	An array of frames corresponding to bank accounts. These frames contain the following slots:
bankAcctNum
A string or rich string that contains the account number.
bankContactNum
A phone number string or rich string for the bank account contact.
creditCards	An array of frames corresponding to credit card accounts. These frames contain the following slots:
creditCardName
A string or rich string for the credit cards name. The user can set the class of this string by picking from the Card popup. The built-in credit card classes are: 
       |string.card|
       |string.card.phonecard|
       |string.card.creditcard|
       |string.card.phonecard.att|
       |string.card.phonecard.mci|
       |string.card.phonecard.sprint|
       |string.card.creditcard.visa|
       |string.card.creditcard.mastercard|
       |string.card.creditcard.amex|
       |string.card.creditcard.discover|
creditCardNum
A string or rich string for the account number.
creditCardExpDate
Either an integer for the expiration date, in number of minutes since midnight, January 1, 1904, or a string or rich string.
creditCardContactNum
A string or rich string for the phone number of the credit card account contact.
signature	The signature the user entered in the signature slip. It is an ink frame.

Group Entries

A group entry consists of a frame with the following slots:
version	The version number of the Names application.
class	The symbol 'group.
cardType	An integer; see Table 16-1 Names card layouts.
group	A string or rich string for the groups name.
groupInfo	Contains a frame with the following slot:
nowShowing	Either the value 'selected or 'all. This reflects whether the user has checked the Selected Only box in the view that adds people to the group.
members	An array containing name reference frames representing the members of the group. These frames are described in Name References (page 5-1) in Newton Programmers Reference. 
notes	An array of note objects. Each element in this array is a frame with the same format as the data slot in a soup entry in the Notes application; see Notes Soup Format (page 16-82).
sorton	A string (not a rich string because of sorting).


Company Entries

Company entries consist of a frame with the following slots: 
version	The version number of the Names application.
class	The symbol 'company.
name	The name the user added by picking affiliate from the Add picker. It is a frame with the following slots:
honorific	A string or rich string for an honorific title, e.g., Ms. or Dr.
first	A string or rich string for a first name.
last	A string or rich string for a last name.
title	A string or rich string for a job title.
names	An array of affiliated names; as added by the user by picking Affiliate from the Add picker, such as company contacts, family members, and so on. This array contains frames such as that for the name slot.
cardType	An integer; see Table 16-1 Names card layouts.
company	A string or rich string for the company name.
address	A string or rich string for the first line of the address.
address2	A string or rich string for the second line of the address.
addresses	An array of frames for additional addresses. These frames contain the following slots: address, address2, city, region, postal_code, and country. 
	city	A string or rich string containing the name of a city.
	region	A string or rich string for region (state in U.S., province in Canada).
	postal_code	A string or rich string for postal code (zip code in U.S.).
	country	A or rich string naming the country. If this is a standard (not rich) string that is recognized by the system as the name of a country, it will have a class as set by SetCountryClass; for more information on this, see the description of SetCountryClass.
phones	An array of strings or rich strings containing phone numbers. The user can set the class of these string by picking from the Phone popup. The built-in phone classes are listed under the phones slot for person entries.
email	A string or rich string for an e-mail address. The user can set the class of this string by picking from the Email popup. The built-in e-mail classes are listed under the email slot for person entries. 
emailAddrs	An array of frames of additional e-mail addresses of the format {email:stringOrRichString}.
notes	An array of note objects. Each element in this array is a frame with the same format as the data slot in a soup entry in the Notes application; see Notes Soup Format (page 16-82).
sorton	A string (not a rich string because of sorting).

Worksite Entries

Worksite entries consist of a frame with the following slots:
version	The version number of the Names application.
class	The symbol 'worksite.
cardType	An integer; see Table 16-1 Names card layouts.
place	A string or rich string for the place name.
dialingPrefix	A string or rich string for dialing prefix needed to get an outside line from this worksite.
areaCode	A string or rich string for the area code of this worksite.
printer	A string representing the printer the user has chosen from among network printers.
mailAccess	An array of frames of the following form: {mailPhone:stringOrRichString, mailNetwork:'concert, 
	baud:1200}
connectionPhone	A phone number string to access e-mail at this site.
connectionNetwork
A string for the AppleTalk Name Binding Protocol (NBP) address. The format of this string is "computerName:Docker@zone".
cityAlias	 An alias to an entry from an undocumented soup which contains informations about the closest city. The soup entry contains slots for the city name, its country, latitude and longitude, etc.
	For more information on entry aliases, see Chapter 11, Data Storage and Retrieval, in Newton Programmers Guide.
countrySymbol	A symbol representing the country.
country	A or rich string naming the country. If this is a standard (not rich) string that is recognized by the system as the name of a country, it will have a class as set by SetCountryClass; for more information on this, see the description of SetCountryClass.
notes	An array of note objects. Each element in this array is a frame with the same format as the data slot in a soup entry in the Notes application; see Notes Soup Format (page 16-82).
sorton	A string (not a rich string because of sorting).

-30-
